| <CHOICE |
Beginning of the choice card header. |
| NAME=card_name |
A name for the card. Other cards can specify this
name as a destination. |
| MARKABLE=boolean |
Flag specifying whether the card can be marked.
To allow the card to be marked, specify TRUE. The default value
is determined by the MARKABLE option for the deck.
Always set MARKABLE=FALSE for
cards that execute or confirm transactions that the user might not want
to repeat.
If you set the MARKABLE=TRUE, it implicitly
sets the PUBLIC option to TRUE, allowing other URLs to
link directly to the card. |
| TITLE=card_title |
The default bookmark name that appears when the
user marks the card. |
| BOOKMARK=mark_URL |
The URL the phone adds to the bookmark list if
the user marks the card. If you do not specify the BOOKMARK option,
the phone adds the URL of the current card to the bookmark list. |
| KEY=var_name |
The name of the variable that gets the value (if
any) of the chosen item. |
| IKEY=var_name |
The name of a variable containing an index number
specifying the default item. The number 1 specifies the first
item, 2 specifies the second item, and so on.
For example, if var_name is
myvar and the value of myvar is 2, the second item is the
default item.
If you don't specify the IKEY option or
the IDEFAULT option, the first item is the default.
When the user chooses an item, the phone sets the
variable specified by IKEY to the number of the chosen item. |
| METHOD=choice_method |
The choice method. To make the list numbered,
specify NUMBER. If the list is numbered, the user can choose an
item by pressing the item's number or by scrolling to it and pressing a
key.
To make the list unnumbered, specify ALPHA.
If the list is unnumbered, the user can choose an item only by scrolling
to it and pressing ACCEPT.
If you do not specify the METHOD
option at all, the choice method defaults to NUMBER.
Note that the phone will number only the first nine items in the list. |
| DEFAULT=default_val |
The default value of the variable specified by
the KEY option. If the variable specified by the KEY option
does not have a value when the card is first displayed, the phone assigns
it the value specified by the DEFAULT option. If the variable
specified by the KEY option already has a value, the DEFAULT
option is ignored. |
| IDEFAULT=default_num |
The index of the default entry, if the IKEY
option is not specified or it specifies a variable with no value.
If the IKEY option is specified, IDEFAULT is ignored. |
| > |
End of the choice card header. |
| actions |
The actions to execute when the user presses a
function key.
If the choice item the user chooses specifies a
task, it takes precedence over these actions.
|
| display_content |
A formatted text title to display above the list
of items. It should be as brief as possible.
Avoid using the <LINE> tag for this
text; if you use it, text that exceeds the display width will be truncated.
Avoid using more than 24 characters of text. If
you use more, it will scroll off the top of the screen on many devices
and the user will have to scroll back to read the entire title.
|
| <CE ...>text |
An item (choice entry) the user can choose.
text is formatted text describing
the choice entry. By default, the UP.Phone always displays the text in
horizontal scrolling (<LINE>) mode. To make it wrap, insert
a <WRAP> statement before the text. If you did not specify
ALPHA for the choice method, the item's number is automatically prepended
to the text. |
| . . . |
Additional items (<CE> statements)
as needed. |
| </CHOICE> |
The choice card footer. |
